************

INTRODUCTION

************

This file describes how to set up and use the .NET wrapper code for Melissa DATA's Address Object.


*************

PREREQUISITES

*************



To make use of the Address Object .NET wrapper sample you will need:



* Visual C# 7 compiler or later version



* The Melissa DATA Address Object library and data files installed.



  These files are installed automatically if you run setup.exe from the root of the DQ Suite DVD. 

  You will need to know the location of these files.



This sample was compiled and tested using .NET 2.0. 



**********************
Wrapper compatibility
**********************

If the provided pre-compiled wrappers are not compatible with your environment, the necessary files for compilation can be found in the 'interfaces' folder of the object's main directory.

The wrappers included in the x64 and x86 folders of this NET samples folder are compiled in 2012, and would need the Visual Studio 2012 redistributable in order to run correctly.
If you are having compatibility issues and would like to use the 2008 compiled versions of the wrappers, they are located in the 'interfaces/2008Wrappers' folder of the object's main directory.


*************

Installation

*************



Copy the entire folder that contains this readme.txt into a local directory on your computer.





*****

Setup

*****



Copy mdAddrNET.dll from the Source folder to your project directory.

Copy mdAddrCS.dll from the Source folder to your project directory. 

Copy mdAddr.dll from /address/windows/dll_64bit* into the same directory as mdAddrCS.dll and mdAddrNET.dll.

	* 32bit version available in /address/windows/dll_32bit



********************

What are these DLL's

********************



mdAddr.dll is the standard DLL version of Address Object used by the .Net wrapper.
mdAddrCS.dll is a intermediary dll that bridges .NET and the unmanaged mdAddr.dll.
mdAddrNET.dll is the .NET assembly which calls mdAddrCS.dll.





*******************

Running the Samples

*******************



Csharp.NET 



Directions can be found in the README file inside the CSharpNet folder.





VB.NET



Open the VBNet\AddressObjectSample\AddressObjectSample.sln 



Open Form1.vb.

Set the data file path to the Address Object data files and your license string in place of "DEMO". Without a valid license string, Address Object will not function. Please call a sales representative at 1-800-800-6245 x3 to obtain a license.



       Const dLICENSE = "DEMO"

       Const dFILELOC = "C:\\Program Files\\Melissa DATA\\DQT\\Data"



To use the .NET wrapper, add a reference to mdAddrNET.dll. 

However, mdAddrNET.dll must be able to find mdAddrCS.dll who must be able to find mdAddr.dll. You can copy all of these files to the same directory, or add the directory of those dll's to the PATH environment variable.



Compile and Run.





********************

Other .NET languages

********************

You can use the dll's provided in another .NET language, because mdAddrNET.dll is a .NET assembly. 





*******

Updates

*******



The files generated/included in this wrapper do not need to be changed for DQ Suite updates unless there is a method signature change in the object. If a new method is added, you will need to rebuild the wrapper to use the new method. 



********************

Re-compiling DLLs

********************

The pre-compiled DLLs are located in the x64 and x86 folders in the same directory as this README. 
If you need to re-compile the mdAddrCS.dll and the mdAddrNET.dll, the necessary files and .bat script are available in the 'interfaces/NET' folder.


****

Note

****



The source code and a bat script to compile mdAddrCS.dll and mdAddrNET.dll is supplied in the Source directory. 

These files are already supplied so you do not need to use them unless you need to recompile. 



If you get a crash or exception when trying to run the sample that says "cannot load dll", make sure to copy mdAddr.dll into the same directory as mdAddrCS.dll or add its directory to the PATH enviornment variable. 







COPYRIGHT NOTICE



(C) 2014 Melissa Data Corporation. All rights reserved.

